home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Archives / Converters / EpsLab_1_02.lha / EpsLab / English / Documentation / EpsLab.doc < prev    next >
Encoding:
Text File  |  1994-11-17  |  12.8 KB  |  517 lines
  1.  
  2.  
  3.  
  4. -------------------
  5. EpsLab - User guide
  6. -------------------
  7.  
  8.  ____________________________________________________________________________
  9.  
  10.  
  11.  
  12.                        EpsLab version 1.02 23-Oct-1994
  13.                       Copyright © 1994 By Alessandro Sala
  14.  
  15.  
  16.                Requires AmigaOS v2.04 ( Kickstart v37 ) or later
  17.  
  18.  
  19.  ____________________________________________________________________________
  20.  
  21.  
  22.  
  23.  
  24.                                     Contents
  25.  
  26.  
  27.                       ·  Legal info               
  28.                       ·  Acknowledgements         
  29.        
  30.                       ·  The distribution archive  
  31.                       ·  What is EpsLab ?             
  32.                       ·  Installation             
  33.                       ·  Localization                 
  34.                       ·  Usage                           
  35.  
  36.  
  37.                       ·  Contacting the author           
  38.                       ·  Revision history         
  39.  
  40.  _____________________________________________________________________________
  41.  
  42.  
  43.  
  44. ----------
  45. Legal Info
  46. ----------
  47.  
  48.                                   ------------
  49.                                    Disclaimer
  50.                                   ------------
  51.  
  52.  
  53.  
  54.    This program is provided "as is" without warranty of any kind, either
  55. expressed or implied, including, but not limited to, the implied warranty of
  56. fitness for a particular purpose.  Though every care has been taken to make
  57. this program system-friendly and bugs-free, the entire risk as to the results,
  58. reliability and performance of this program is assumed by you.
  59.  
  60.  
  61.  
  62.                                ------------------
  63.                                 Copyright notice
  64.                                ------------------
  65.  
  66.  
  67.  
  68.    This program is "FreeWare": it can be freely copied and distributed for
  69. non-commercial purposes, provided that no file is added to or removed from the
  70. distribution archive and no charge, beside a nominal fee, is requested.
  71.  
  72.  
  73.  
  74.    Fred Fish is, of course, explicitly allowed to put this program on his
  75. great disk library and/or on his CD-ROMs.
  76.  
  77.  
  78.    Aminet administrators are also explicitly allowed to put this program on
  79. Aminet CD-ROMs.
  80.  
  81.  
  82.  
  83.    Nevertheless the program remains COPYRIGHT of the Author: you cannot patch,
  84. reverse engineer or otherwise modify the program, the documentation and every
  85. other file found in the distribution archive except where explicitly allowed.
  86.    Compressing in executable form is allowed for personal use but not for
  87. distribution. The only two allowed forms of distribution are the original
  88. lharc'ed archive or a uncompresssed form of it.
  89.    Furthermore you cannot embed the program in any other software without the
  90. written permission of the author.
  91.  
  92.  
  93.  
  94. --------------
  95. Acknoledgement
  96. --------------
  97.  
  98.  
  99.  Very big thanks to Manuel Lemos: almost all the features of EpsLab came from
  100. his suggestions after I released BinEps.
  101.  
  102.  
  103.  In particular, Manuel suggested the use of the 'post.library' to render the
  104. preview image; he suggested where to find the TIFF documents, and suggested to
  105. add the EPSI format support.
  106.  He also did a great beta-testing job, and helped making the GUI closer to
  107. Commodore's (or should now I say Amiga International's ?) style-guide.
  108.  
  109.  
  110.                 Thanks Manuel!
  111.  
  112.  
  113. -----
  114.  
  115.  
  116. And now for the legal stuff:
  117.  
  118.  
  119.         PostScript® is a registered trademark of Adobe Systems Incorporated.
  120.  
  121.  
  122.         TIFF (tm) is a trademark of Aldus Corporation.
  123.  
  124.  
  125.         Post and post.library are Copyright by Adrian Aylward.
  126.  
  127.  
  128.  
  129. --------------------
  130. Distribution archive
  131. --------------------
  132.  
  133.  
  134.                       ------------------------------------
  135.                       Contents of the distribution archive
  136.                       ------------------------------------
  137.  
  138.  
  139.  
  140.     EpsLab             : The main executable program
  141.  
  142.  
  143.     Italiano
  144.       Leggimi          : General information (italian language)
  145.       Installa         : Installer program (italian language)
  146.       Documentazione
  147.         EpsLab.doc     : Italian documentation in plain ASCII format
  148.         EpsLab.guide   : Italian documentation in AmigaGuide format
  149.  
  150.  
  151.     English
  152.       ReadMe           : General information (english language)
  153.       Install          : Installer program (english language)
  154.       Documentation
  155.         EpsLab.doc     : English documentation in plain ASCII format
  156.         EpsLab.guide   : English documentation in AmigaGuide format
  157.  
  158.  
  159.     Catalogs
  160.       EpsLab.ct        : Empty translation catalog.
  161.       Italiano
  162.         EpsLab.catalog : Catalog file for italian language support
  163.  
  164.  
  165.     Libs
  166.       post.library     : PostScript library (by Adrian Aylward).
  167.  
  168.  
  169.     PS
  170.       init.ps          : PostScript preamble (also by Adrian Aylward).
  171.       FunkyFont        : Default PostScript font (by Radical Eye Software)
  172.       afms
  173.         FunkyFont.afm  : Default PostScript font metrics
  174.  
  175.  
  176.  
  177.     Various '.info' files
  178.  
  179.  
  180.  
  181. --------------
  182. What is EpsLab
  183. --------------
  184.  
  185.  EpsLab is the successor of BinEps: its main purpose is to add a preview image
  186. to a regular Encapsulated PostScript file ('.epsf'); it can also convert some
  187. single-page PostScript files to EPS files (with a preview image).
  188.  
  189.  
  190.  The preview image can be created by EpsLab in one of three formats:
  191.  
  192.  
  193.     - TIFF image (MS-DOS binary EPS format)
  194.     - TIFF compressed image (also MS-DOS binary EPS format)
  195.     - ASCII image (EPSI file format)
  196.  
  197.  
  198.  As an alternative the user can provide a file containing the preview image in
  199. either TIFF format o Windows MetaFile format.
  200.  Its resolution doesn't matter: it can be of any size and aspect ratio; the
  201. application displaying the preview should scale the picture to fit within the
  202. %%BoundingBox comment specified in the EPS file.
  203.  
  204.  
  205.  
  206. ------------
  207. Installation
  208. ------------
  209.  
  210.  Simply run the provided installer script, found in the 'English' drawer. You
  211. need the 'installer' program from Commodore: please have a look at the ReadMe
  212. file for details on obtaining 'installer' if you don't already have it.
  213.  
  214.  
  215.  If you want to install EpsLab by hand:
  216.  
  217.  
  218.     - make a drawer somewhere to store EpsLab
  219.     - copy EpsLab, the 'catalogs' drawer and PS/init.ps into that drawer
  220.  
  221.  
  222.  If you want EpsLab to create full preview images and you don't already have
  223.  post.library installed, do the following:
  224.  
  225.  
  226.     - copy Libs/post.library to LIBS:
  227.     - choose a drawer to store the PostScript fonts, and add the following
  228.         line to your user-startup:
  229.  
  230.  
  231.             assign PSFONTS: '<your-drawer-path>'
  232.  
  233.  
  234.     - copy PS/FunkyFont to PSFONTS:
  235.     - make a drawer named 'afms' inside PSFONTS:
  236.     - copy PS/afms/FunkyFont.afm to PSFONTS:afms
  237.  
  238.  
  239.     - reboot your computer
  240.  
  241.  
  242.  
  243. ! IMPORTANT NOTE !
  244.  
  245.  
  246.  Please note that, to keep the archive small, I have only included one simple
  247. and freely distributable PostScript font (FunkyFont by Radical Eye Software).
  248. It's rather simple, but it works. If you want more PostScript fonts, get
  249. 'Post', a freely distributable PostScript interpreter by Adrian Aylward, based
  250. on the post.library (also by Adrian Aylward). If you have a math coprocessor
  251. (FPU), with 'Post' you can also find an optimized version of the post.library
  252. which runs about twice as fast.
  253.  
  254.  
  255.  
  256. ------------
  257. Localization
  258. ------------
  259.  
  260.  EpsLab is fully localized, if you have AmigaOS v2.1 or later. At the moment
  261. the only supported languages are Italian and English. If you want to localize
  262. EpsLab for your own language, you can find an empty catalog translation file
  263. in the 'Catalogs' drawer. Edit it and send it to me, so I can make the catalog
  264. and distribute your translation.
  265.  
  266.  
  267.  If you want to translate the documentation, please work only on the
  268. Amigaguide version of it. I will extract the plain ASCII version.
  269.  
  270.  
  271.  
  272. -----
  273. Usage
  274. -----
  275.  
  276.  
  277.  EpsLab can be run both from CLI and from Workbench.
  278.  
  279.  
  280.  The CLI template is
  281.  
  282.  
  283.         EpsLab SOURCE,DEST,TIFF/K,WMF/K,POST/S,OUTFMT/N/K,
  284.                 INIT/K,XDPI/N/K,YDPI/N/K,GUI/S,RECBB/S,
  285.                 PSIZE/N/K,CUSTW/K,CUSTH/K,UNIT/N/K
  286.  
  287.  
  288.  All the CLI arguments can also be used as tooltypes when EpsLab is run from
  289. Workbench: in this case they will set the default values.
  290.  
  291.  
  292.  Here is the meaning of the various arguments/tooltypes (type 'EpsLab ?' at
  293. the CLI prompt to get a little on-line help):
  294.  
  295.  
  296.  
  297.     SOURCE
  298.             The name of the PostScript or EPS file to be processed. It is
  299.             mandatory when you run EpsLab from CLI.
  300.  
  301.  
  302.  
  303.     DEST
  304.             The name of the processed EPS file. If you don't provide
  305.             a destination name, it will be created from the source filename:
  306.  
  307.  
  308.             - if the resulting file is in binary format (TIFF or WMF preview)
  309.                 the name of the source file will be prepended with 'b_'.
  310.  
  311.  
  312.             - if the resulting file is an EPSI file, the source file
  313.                 extension will be changed to '.epsi'.
  314.  
  315.  
  316.  
  317.  The following three arguments are mutually exclusive; if you use none of
  318. them, the preview image will be a crossbox:
  319.  
  320.  
  321.     TIFF=<file>
  322.             The name of a TIFF file to be used as a preview image.
  323.  
  324.  
  325.  
  326.     WMF=<file>
  327.             The name of a WMF file to be used as a preview image.
  328.  
  329.  
  330.  
  331.     POST
  332.             Use post.library to create the preview image.
  333.  
  334.  
  335.  
  336.  The remaining arguments:
  337.  
  338.  
  339.     OUTFMT=<n>
  340.             This sets the output format of the destination file when
  341.             the POST option is in use.
  342.             Accepted values are:
  343.  
  344.  
  345.                 0 = Binary EPSF with TIFF preview
  346.                 1 = Binary EPSF with compressed TIFF preview
  347.                 2 = EPSI format (ASCII preview)
  348.  
  349.  
  350.             Default is 0 (binary EPSF with TIFF uncompressed preview).
  351.  
  352.  
  353.  
  354.     INIT=<file>
  355.             When using the POST option, this is the name of the PostScript
  356.             preamble to read before interpreting the source file.
  357.             Default is 'init.ps'.
  358.  
  359.  
  360.  
  361.     XDPI=<n>
  362.     YDPI=<n>
  363.             When using the POST option, these set the horizontal and vertical
  364.             density of the preview image in dots per inch.
  365.             Default for XDPI is 80. Default for YDPI is XDPI.
  366.  
  367.  
  368.  
  369.     GUI
  370.             This forces EpsLab to open its graphical user interface even if
  371.             run from CLI.
  372.  
  373.  
  374.  
  375.     RECBB
  376.             Forces EpsLab to (re)calculate the bounding box of the image.
  377.             This is useful when converting single-page PostScript files to
  378.             the EPS format. Use the RECBB option if the converted file, when
  379.             imported into a document, shows a blank border around your
  380.             graphics.
  381.  
  382.  
  383.  
  384.     PSIZE=<n>
  385.             When converting PostScript to EPS, this is the size of the
  386.             page when not set inside the PostScript file.
  387.             Accepted values are:
  388.  
  389.  
  390.                 0 = DIN A5
  391.                 1 = DIN A4
  392.                 2 = DIN A3
  393.                 3 = US Legal
  394.                 4 = US Letter
  395.                 5 = Custom (see CUSTW and CUSTH).
  396.  
  397.  
  398.             Default is 1 (DIN A4).
  399.  
  400.  
  401.  
  402.  
  403.     CUSTW=<n>
  404.     CUSTH=<n>
  405.             When PSIZE=5, these represent the width and the heigth of the
  406.             page to be used to render the PostScript document. See UNIT to
  407.             know how to express the page size.
  408.  
  409.  
  410.  
  411.     UNIT=<n>
  412.             This is the unit of measurement used to specify the page size.
  413.             Accepted values are:
  414.  
  415.  
  416.                 0 = Centimeters
  417.                 1 = Inches
  418.                 2 = Points (1/72")
  419.  
  420.  
  421.            Default is 0 (Centimeters).
  422.  
  423.  
  424.  When you run EpsLab from Workbench or from CLI with the GUI argument, it will
  425. open a graphical user interface. Gadgets and menus are self-explanatory. The
  426. 'Settings/Save settings' item saves the current settings as tooltypes.
  427.  
  428.  
  429.  
  430. ---------------------
  431. Contacting the author
  432. ---------------------
  433.  
  434.  
  435.                            Criticism and suggestions
  436.  
  437.  
  438.  
  439.    I hope you will find EpsLab useful, and if you have any criticism,
  440. suggestions, bug report, ideas for enhancements in possible future versions,
  441. or if you have problems using EpsLab and need help, you can write ( in Italian
  442. or English ) to the following address:
  443.  
  444.  
  445.  
  446.         Alessandro Sala
  447.         Via A. Grandi, 16
  448.         20014 Nerviano (MI)
  449.         Italy
  450.  
  451.  
  452.  
  453.   If you have E-Mail capability you can also contact me at the following
  454. Internet address (until the end of October, 1994):
  455.  
  456.  
  457.  
  458.        tser1500@cdc8g5.cdc.polimi.it
  459.  
  460.  
  461.  
  462.   Only if it doesn't work, you can try:
  463.  
  464.  
  465.  
  466.        sala@aix1.cdc.polimi.it      
  467.  
  468.  
  469.   As a last chance, try to find a new version of EpsLab or some other program
  470. by me, to see if there are new addresses available.
  471.  
  472.  
  473.  
  474. ----------------
  475. Revision history
  476. ----------------
  477.  
  478.  
  479.  ------------
  480.  Version 1.02
  481.  ------------
  482.  
  483.  
  484.     First release.
  485.  
  486.  
  487.     Being EpsLab the successor of BinEps, here you can find what's new
  488.     from BinEps.
  489.  
  490.  
  491.     - Full font-sensitive gui.
  492.  
  493.  
  494.     - Full localization.
  495.  
  496.  
  497.     - Ability to create a crossbox preview.
  498.  
  499.  
  500.     - Ability to render a full preview using 'post.library'.
  501.  
  502.  
  503.     - Ability to create a compressed or uncompressed TIFF preview.
  504.  
  505.  
  506.     - Ability to create an ASCII preview (EPSI file format).
  507.  
  508.  
  509.     - Automatic conversion of some single-page PostScript to EPSF, with bounding
  510.         box recalculation.
  511.  
  512.  
  513.     - Selectable density for the preview image.
  514.  
  515.  
  516.     - Selectable page size for PostScript to EPSF conversion.
  517.